home *** CD-ROM | disk | FTP | other *** search
/ Aminet 32 / Aminet 32 (1999)(Schatztruhe)[!][Aug 1999].iso / Aminet / dev / misc / MysticLib.readme < prev    next >
Text File  |  1999-07-01  |  4KB  |  111 lines
  1. Short:    RTG image viewing library
  2. Author:   Timm S. Müller
  3. Uploader: Timm S. Müller (Timm.Mueller@darmstadt.netsurf.de)
  4. Version:  4.2
  5. Type:     dev/misc
  6. Requires: Kickstart 3.0 (v39), MC68020
  7.  
  8.  
  9.   mysticview.library is the third abstraction layer in top of
  10.   guigfx.library and render.library.
  11.   
  12.   mysticview.library implements an RTG image display class. it
  13.   renders images of any kind to a RastPort on any screenmode.
  14.  
  15.   there are no considerations on the programmer's side
  16.   required for issues such as screenmodes, aspect ratios,
  17.   scaling, OCS/ECS/AGA, HAM, chunky/planar, 8bit, 1bit, 24bit
  18.   or alike. all you have to do is to specify a Screen, a
  19.   RastPort, a guigfx.library 'picture' and some attributes.
  20.   images will be rendered, scaled and dithered automatically,
  21.   when needed.
  22.  
  23.   rendering and layouting takes place in the background. you
  24.   create the object, and forget it. the background task
  25.   instantly reacts to changes of attributes and will redraw
  26.   the display when needed. opaque scaling and SIMPLE_REFRESH
  27.   is easily implemented, you only need to supply new
  28.   attributes. a protection mechanism is implemented for
  29.   sharing the RastPort between your application and the
  30.   background task of mysticview.library.
  31.  
  32.   this library makes it REALLY EASY to display any kind of
  33.   pictures inside any kind of application. there are no
  34.   examples included in this archive - the basic implementation
  35.   looks like this:
  36.   
  37.   APTR picture, mview;
  38.   
  39.   picture = LoadPicture("filename", TAG_DONE);
  40.  
  41.   mview = MV_Create(screen, rastport, MVIEW_Picture, picture,
  42.      TAG_DONE);
  43.  
  44.   if (mview)
  45.   {
  46.     MV_DrawOn(mview);
  47.     while(...) { /* image visible */ }
  48.   }
  49.   
  50.   MV_Delete(mview);
  51.   DeletePicture(picture);  
  52.  
  53.   mysticview.library is the fully encapsulated display engine
  54.   of the image viewer 'MysticView'. you are free to use this
  55.   library in freeware and shareware applications.
  56.  
  57.  
  58. requirements
  59. --------------------------------------
  60.  
  61.   - os3.0 (v39)
  62.   - 68020, minimum suggested: 68030/50
  63.   - guigfx.library v16 (dev/misc/guigfxlib.lha)
  64.   - render.library v30 (dev/misc/renderlib.lha)
  65.  
  66.   supports
  67.   
  68.   - higher cpu, fpu
  69.   - os3.1 (v40)
  70.   - cybergraphics, picasso96
  71.  
  72.  
  73. ============================= Archive contents =============================
  74.  
  75. Original  Packed Ratio    Date     Time    Name
  76. -------- ------- ----- --------- --------  -------------
  77.      441     180 59.1% 23-May-99 21:41:52 +doc.info
  78.      324     173 46.6% 01-Aug-98 23:38:24 +author.info
  79.      441     179 59.4% 23-May-99 21:45:28 +autodoc.info
  80.    20986    5058 75.8% 07-Jun-99 05:12:14 +mysticview
  81.    17762    4620 73.9% 07-Jun-99 05:11:42 +mysticview.doc
  82.      324     177 45.3% 23-May-99 21:42:46 +mysticview.doc.info
  83.      324     175 45.9% 23-May-99 21:42:46 +mysticview.info
  84.      324     175 45.9% 01-Aug-98 23:38:24 +history.info
  85.     2200     883 59.8% 23-May-99 21:43:40 +legal
  86.      324     175 45.9% 01-Aug-98 23:38:24 +legal.info
  87.      450     200 55.5% 23-May-99 21:41:52 +fd.info
  88.      450     200 55.5% 23-May-99 21:41:52 +include.info
  89.      450     193 57.1% 23-May-99 21:41:52 +libs.info
  90.      324     175 45.9% 23-May-99 21:41:52 +README.info
  91.      550     313 43.0% 07-Jun-99 05:15:42 +author
  92.     2259    1043 53.8% 07-Jun-99 04:47:08 +history
  93.      364     198 45.6% 23-May-99 21:38:46 +mysticview_lib.fd
  94.      827     351 57.5% 31-May-99 12:22:28 +mysticview_protos.h
  95.     3279    1124 65.7% 01-Jun-99 12:20:34 +mysticview.h
  96.      639     218 65.8% 23-May-99 21:38:10 +mysticview_pragmas.h
  97.      196     134 31.6% 24-Dec-97 02:07:38 +mysticview.h
  98.    30500   16396 46.2% 07-Jun-99 04:04:24 +mysticview.library
  99.    24264   12831 47.1% 07-Jun-99 04:06:52 +mysticview.library_68060
  100.    24012   12785 46.7% 07-Jun-99 04:05:38 +mysticview.library_FPU
  101.     2186    1097 49.8% 07-Jun-99 04:45:30 +README
  102.      441     181 58.9% 07-Jun-99 05:22:26  MysticLib.info
  103.      436     177 59.4% 23-May-99 21:44:54 +maxonc.info
  104.      739     247 66.5% 23-May-99 21:40:12 +mysticview.lib
  105.      689     259 62.4% 23-May-99 21:40:12 +mysticview_lib.h
  106.      436     178 59.1% 23-May-99 21:45:10 +stormc.info
  107.      849     281 66.9% 23-May-99 21:39:36 +mysticview_lib.h
  108.      139     128  7.9% 23-May-99 20:52:34 +mysticview_pragmas.h
  109. -------- ------- ----- --------- --------
  110.   137929   60504 56.1% 07-Jun-99 15:03:16   32 files
  111.